home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr14 / dicemstr.zip / DICEMSTR.DOC next >
Text File  |  1993-04-01  |  15KB  |  368 lines
  1.  
  2.  
  3.  
  4.           
  5.                                   Dice Master
  6.                                  Version 1.00
  7.                                 By David Brumbaugh
  8.                           Copyright (c) 1991, David Brumbaugh
  9.           
  10.         Introduction
  11.           
  12.           Dice Master is a program for Game Masters (and to a lesser extent
  13.           players) of various role playing games (like D&D and AD&D).  It
  14.           is a "Mass Dice Roller".  It allows the GM to generate lots and
  15.           lots of random numbers quickly in various dice-like combinations.
  16.           Dice Master is intended primarily as a preparation tool, not
  17.           a program to run during the game (although you could, and I
  18.           have on occasion).
  19.           
  20.           I am a Dungeon Master for two regular campaigns playing a total
  21.           of three times a month. I still write most of my own adventures.
  22.           That means I have about a week to prepare each one. When
  23.           determining things like monster hit points, NPC stats etc., I
  24.           found that I had one major slow down: DICE ROLLING. In order to
  25.           speed things up I started just making up numbers in the right
  26.           range, or using maximums or minimums or averages. It worked, but
  27.           it seemed to detract from the "fairness" of the game. I wrote
  28.           Dice Master to put some of the fairness back into the game,
  29.           without having to take all the time to roll each die separately.
  30.         
  31.           
  32.         Shareware Notice
  33.           
  34.           I am distributing Dice Master as Shareware. That means if you use
  35.           it and are satisfied, you pay me for the program. I am asking
  36.           $5.00 for Dice Master registration.
  37.           
  38.           Registered users receive the following benefits:
  39.  
  40.               1. Upgrade Notices- I will send a postcard notifying you of any
  41.               upgrades to Dice Master. Depending on the nature of the upgrade
  42.               it will either cost you postage and handling or a discounted
  43.               registration fee. I will also include in the notice the BBSs
  44.               that I have uploaded to so you may download without the cost of
  45.               postage and handling.
  46.           
  47.               2. My Home Phone Number- I will gladly talk to any
  48.               registered user of my software, answer questions, etc. If you
  49.               get my answering machine and you are registered, I will
  50.               return your call.
  51.           
  52.               3. Notice Of and Discount On Any Subsequent Related Software-
  53.               Dice Master is the first of several utilities for Game
  54.               Masters. If I get a good response to Dice Master, I will make
  55.               the others available as Shareware. The following programs are
  56.               planned:
  57.  
  58.                   A. Windows Dice Master - This Program for MS-Windows 3
  59.                   B. Table Master - A Program to Mass Produce Rolls Against
  60.                   Your Own Customized Tables.
  61.                   C. D-Master - A comprehensive set of Game Master
  62.                   Utilities. Includes Character, NPC and Creature
  63.                   Generators, Databases, and More.
  64.  
  65.  
  66.  
  67.         
  68.              4. Source Code- The C++ source code will be made available
  69.                 to registered users ONLY. The cost is $25.00.
  70.         
  71.         How Dice Master Works
  72.           
  73.           Dice Master has two modes of operation, command line and menu
  74.           driven. Menu mode is the easiest to learn and follow. Command
  75.           line mode is the fastest to use.
  76.           
  77.           In all modes you must tell what type of dice (number of sides)
  78.           and how many of those dice to roll to get a total. You also have
  79.           several options. You can specify how many of the rolls to keep.
  80.           You can choose a constant to add to the roll. You can specify how
  81.           many sets, and to a certain extent the format of the output. You
  82.           can also decide to send the output to a file, the screen or the
  83.           printer.
  84.         
  85.         Command Line Mode
  86.           
  87.           The command line is designed to be used just like standard gaming
  88.           die notation. If you want the total of four eight sided dice you
  89.           would type, "roll 4d8", at the command prompt. The formal command
  90.           line syntax for Dice Master follows. Any term enclosed in square
  91.           brackets, [], is optional. Any term enclosed in greater than/less
  92.           than symbols, <>, means you have to supply a value. The | symbol
  93.           means "OR". All other characters are to be taken literally.
  94.           
  95.             FORMAL DICE MASTER SYNTAX:
  96.             roll [/?|[<K>+][<N>]d<S>[t<T>] [+...] [;<columns>[x<rows>]]]
  97.           
  98.             Where:
  99.             - /? is the help option.
  100.             - K is a constant
  101.             - N is the number of dice to roll
  102.             - d is literally the letter 'd'
  103.             - S is the number of sides
  104.             - t is literally the letter 't'
  105.             - T is the number of top rolls to include
  106.             - + means add the following term
  107.             - ... means repeat [<K>+][<N>]d<S>[t<T>] as needed
  108.             - ; is literally the semi-colon character, it indicates that an
  109.               output format follows.
  110.             - columns is the number of columns of results that will be
  111.               output (the default is one).
  112.             - rows is the number of rows of results t hat will be output
  113.               (the default is one).
  114.             - If no options are chosen, you get the menu.
  115.         
  116.           
  117.         Examples
  118.           
  119.           To get the help screens type:
  120.                   roll /?
  121.           at the command prompt.
  122.           
  123.                                  AD&D GAME EXAMPLES
  124.           
  125.           1. Prepare a list of to hit and saving throw rolls for a mass combat
  126.              including lots of monsters and NPCs.
  127.  
  128.  
  129.  
  130.                   roll d20;5x10
  131.           Sample Results:
  132.                   13 13 10 15 14
  133.                   17 10 20 8 20
  134.                   10 13 3 10 9
  135.                   1 17 13 11 13
  136.                   5 15 12 12 20
  137.                   2 13 8 18 1
  138.                   16 1 15 14 19
  139.                   5 1 16 2 17
  140.                   16 3 7 7 15
  141.                   12 4 4 10 20
  142.           
  143.           2. Roll hit points for a 5th level Warrior with a Constitution of 16.
  144.              Expected Minimum: 15, Expected Maximum: 60
  145.                   roll 10+5d10
  146.           Sample Results:
  147.                   43
  148.           
  149.           3. Roll hit points for 100 Hobgoblins, display results in a 10 x 10
  150.              matrix.  Expected Minimum: 2, Expected Maximum: 9
  151.                   roll d8+1;10x10
  152.           Sample Results:
  153.                   4 3 9 8 8 5 5 2 8 6
  154.                   2 3 7 4 4 2 8 9 7 5
  155.                   7 7 3 4 7 8 5 2 9 5
  156.                   4 7 9 4 6 2 4 7 4 5
  157.                   8 4 3 4 3 4 7 3 2 8
  158.                   2 8 9 7 7 3 9 6 4 3
  159.                   4 3 7 7 8 5 7 2 5 3
  160.                   5 2 4 5 6 6 8 2 6 8
  161.                   7 6 4 6 9 9 3 6 4 3
  162.                   2 4 5 6 2 8 2 2 6 9
  163.           
  164.           
  165.           4. Roll ability scores for ten NPCs using Method V from AD&D Second
  166.              Edition Players Handbook (4d6, keep the top three from each
  167.              set).  Expected Minimum: 3, Expected Maximum: 18
  168.                   roll 4d6t3;6x10
  169.           Sample Results:
  170.                   14 13 13 6 9 10
  171.                   14 13 6 11 11 15
  172.                   11 16 18 12 14 14
  173.                   16 13 15 14 11 16
  174.                   15 15 13 10 10 17
  175.                   12 10 13 13 15 11
  176.                   13 9 9 15 13 18
  177.                   9 12 12 7 7 9
  178.                   16 12 11 13 16 14
  179.                   8 16 13 13 12 16
  180.           
  181.           
  182.           5. Roll twenty random encounters from a table in one of the Monstrous
  183.              Compendiums ( Roll a d8 and a d12 and add the results).
  184.              Expected Minimum: 2, Expected Maximum: 20
  185.                   roll d8+d12;20
  186.           Sample Results:
  187.                   14 15 15 11 17 15 2 15 15 9 3 7 9 15 13 7 11 15 6 10
  188.           
  189.         
  190.  
  191.  
  192.  
  193.         Redirection
  194.         
  195.           The command line output of Dice Master goes to what DOS calls
  196.           Standard Out. Standard Out can be redirected with the
  197.           following symbols:
  198.                 >  - Send the output to a device or file
  199.                 >> - Append the output to a file
  200.                 |  - Send the output of this command to the input of the
  201.                      next command.
  202.           See your DOS manual for a complete discussion of redirection.
  203.         
  204.           Examples:
  205.         
  206.           1. Send the output of sample one above to the printer for use
  207.           in later play.
  208.                   roll d20;5x10 > LPT1
  209.         
  210.           2. Send the output of sample four above to a file with other
  211.           NPC stats for later editing.
  212.                   roll 4d6t3;6x10 >> STATS.NPC
  213.         
  214.           3. Sort a list of ten rolls of 1d6.
  215.                   roll  d6;1 x 10 | sort
  216.           Sample Results:
  217.                   1
  218.                   2
  219.                   3
  220.                   3
  221.                   4
  222.                   5
  223.                   5
  224.                   5
  225.                   6
  226.                   6
  227.         
  228.         
  229.         Menu Mode
  230.         
  231.           The menu mode is primarily for learning to use Dice Master.
  232.           The command line is easier and faster in most cases, once you
  233.           understand it.
  234.         
  235.           To use menu mode just type ROLL at the command prompt. The menu
  236.           has four choices:
  237.                   1. Fast Rolling
  238.                   2. Simplified Rolling
  239.                   3. Help
  240.                   4. Exit
  241.           
  242.           Choice 1, Fast Rolling, is like the command line mode with
  243.           two exceptions, you don't enter the row and column on the
  244.           command line, it prompts you for them. Also, it prompts you
  245.           for where you want the output to go.
  246.         
  247.           After you type 1 at the menu the right side of the screen
  248.           will become a work space. At the "ROLL:" prompt, enter the
  249.           dice notation that indicates how you want to roll. See the
  250.           examples above.
  251.         
  252.           After you have entered your roll notation, it will ask you
  253.  
  254.  
  255.  
  256.           how many columns you want to see. It will default to 1. Enter
  257.           the number you want. Next it will ask you how many rows.
  258.           Repeat as for columns.
  259.         
  260.           Finally, it will prompt you for the destination.  If you enter
  261.           S, the output will go to the screen. Strike any key to return
  262.           to the menu. If you enter P, it will send the output to the
  263.           printer. (This uses the DOS Standard Print, or PRN).  If you
  264.           enter F you are then asked to enter a file name. The output
  265.           is APPENDED to the file you specify if it exists. Otherwise,
  266.           it creates the file and sends the output to it. Press ESC at
  267.           any time to return to the menu.
  268.         
  269.           Choice 2, Simplified Rolling, walks you through each step of
  270.           the rolling process. The questions are pretty much
  271.           self-explanitory. It asks how many sides, how many you want
  272.           to roll, etc. The destination choice behaves exactly like it
  273.           does in Choice 1. Choice 2 is too cumbersome for regular use,
  274.           but I included it as a learning tool.  Press ESC at any time
  275.           to return to the menu.
  276.         
  277.         
  278.           Choice 3, Help, is the same set of screens you get when you
  279.           type "ROLL /?". The screens contain a synopsis of this
  280.           document.
  281.         
  282.           Choice 4, Exit, returns you to DOS.
  283.         
  284.         Technical Notes
  285.         
  286.         DOS 5 Users
  287.         
  288.           Because the /? option gives help, you may include Dice Master
  289.           in your DOS help file. If you want to do this, simply go to
  290.           your DOS directory and type "EDIT DOSHELP.HLP".  I placed the
  291.           line, "ROLL A Mass Dice Rolling Routine", right after RMDIR.
  292.           Then if you type "HELP ROLL" at the command prompt, you will
  293.           get the Dice Master help screens.
  294.         
  295.         
  296.         Programmers
  297.         
  298.           Dice Master is written in Borland C++, version 2.0.  It is a
  299.           mixture of Procedural and Object Oriented code. The Menu and
  300.           Work Area screens were drawn with a shareware product called
  301.           "TheDraw". "TheDraw" generates compressed text mode screens.
  302.         
  303.           I had many libraries already written in C. The procedural
  304.           parts of the code use those libraries. The only real object I
  305.           have in the program is a Die.
  306.         
  307.           Source code for this program is available to registered users
  308.           for $25.00.
  309.  
  310.  
  311.         
  312.         Compression
  313.           A VERY GOOD public domain program called LZEXE was used to
  314.           compress ROLL.EXE. This has two effects. First, Dice Master
  315.           takes about half as much room on your hard disk as it would
  316.           otherwise. (This is VERY nice for laptops.) Second, there is a
  317.           built in CRC check. That means that if a virus infects your
  318.           program, you may get a CRC error. This offers a certain level
  319.           of virus protection.
  320.         
  321.         
  322.         Disclaimer
  323.           DICE MASTER IS PROVIDED AS SHAREWARE "AS IS". THE AUTHOR MAKES NO
  324.           WARRANTIES, EITHER EXPRESSED OR IMPLIED WITH RESPECT TO THIS
  325.           PROGRAM, ITS ACCURACY, OR ITS SUITABILITY TO YOUR PURPOSES.
  326.           THIS DOCUMENT CONTAINS SEVERAL TRADEMARKS AND REGISTERED TRADEMARKS.
  327.           ALL TRADEMARKS ARE HERE BY RECOGNIZED EN-MASSE. ANY USE OF A
  328.           TRADEMARK WITHOUT EXPLICIT RECOGNITION OF ITS TRADEMARK STATUS
  329.           SHALL NOT BE CONSTRUED TO BE A CHALLENGE TO SUCH A STATUS.
  330.  
  331.         
  332.         Shareware Registration
  333.           If you like this program, and would like to see more like it,
  334.           please register it by filling out and sending the following
  335.           form.
  336.  
  337.           =============================================================
  338.                         Dice Master Version 1.00 Registration
  339.         
  340.           Name:____________________________________________________
  341.         
  342.           Address:_________________________________________________
  343.         
  344.           City:________________________ State:_________ Zip:_______
  345.         
  346.           Phone:______________________
  347.         
  348.           Enclosed is:          __ $ 5.00 - Registration
  349.                                 __ $25.00 - Source Code
  350.         
  351.           I am a Game Master for the following role playing games:
  352.         
  353.           ______________________________________________________________
  354.         
  355.           I am a Player of the following role playing games:
  356.         
  357.           ______________________________________________________________
  358.         
  359.           I am Interested in Seeing You Write:
  360.  
  361.            __ Windows Dice Master
  362.            __ Table Master
  363.            __ D-Master
  364.  
  365.          I __AM __AM NOT  a Windows User.
  366.  
  367.  
  368.